Skip to main content

API Token Management

tip
  • Both Admins and Developers can create tokens.
  • Admins can access and manage all tokens
  • Developers can access and manage only their own tokens

Create an API Token

  • Application name: display-only label for your reference
  • Scopes: auto-assigned based on your role
    • Admin → user/*.*, system/*.*
    • Developer → user/*.*
  • Expiration: None

View the Token

ImgGenerate
Copy!

Copy the Token since it will not be displayed again

Managing Tokens

ImgListed
  • Revoke or permanently delete tokens at any time
  • Create multiple tokens per user as needed
  • Rotate tokens regularly; revoke old ones

Use the Token

Example: list Patients

curl -H "Authorization: Bearer <token>" \
-H "Accept: application/fhir+json" \
https://your-domain/fhir/Patient?_count=10

Tips

  • Store tokens securely; treat them like passwords
  • Prefer short-lived tokens and regular rotation
  • If a token is exposed, revoke it immediately